<?php
declare(strict_types=1);

namespace Zms\Unit;

/**
 * 数组工具类
 */
class Lists
{
    /**
     * 将列表转为字符列表
     * @param array $list
     * @return array
     */
    public static function toStringList(array $list): array
    {
        foreach ($list as &$item) {
            $item = (string)$item;
        }
        return $list;
    }


    /**
     * 将列表转为整型列表
     * @param array $list
     * @return array
     */
    public static function toIntList(array $list): array
    {
        foreach ($list as &$item) {
            $item = (int)$item;
        }
        return $list;
    }


    /**
     * 删除列表中的指定值
     * @param $list
     * @param $value
     * @return array
     */
    public static function deleteValue($list, $value): array
    {
        $data = [];
        foreach ($list as $item) {
            if ($item !== $value) {
                $data[] = $item;
            }
        }
        return $data;
    }


    /**
     * 检测字符串列表中是否含有空字符串
     * @param array $list
     * @return bool
     */
    public static function existsEmptyString(array $list): bool
    {
        foreach ($list as $item) {
            if (Is::empty($item)) {
                return true;
            }
        }
        return false;
    }


    /**
     * 获取列表最后一个元素
     * @param array $array
     * @return mixed
     */
    public static function last(array $array)
    {
        if (count($array) === 0) {
            return 0;
        }
        return end($array);
    }


    /**
     * 从列表随机取出一个元素
     * @param array $list
     * @return mixed
     */
    public static function rand(array $list)
    {
        return $list[rand(0, count($list) - 1)];
    }


    /**
     * 检查值是否存在于数组中。
     * 此方法使用严格比较（===）来检查给定值是否存在于数组中。
     * 它利用PHP内置的 `in_array` 函数，并设置第三个参数为 `true` 来启用严格类型比较。
     * @param mixed $value 需要在数组中查找的值。
     * @param array $array 要搜索的目标数组。
     * @return bool 如果值在数组中存在，则返回 true；否则返回 false。
     *
     * 示例:
     * 输入: 5, [1, 2, 3, 4, 5]
     * 调用 self::exists(5, $array) 将返回 true
     *
     * 输入: '5', [1, 2, 3, 4, 5]
     * 调用 self::exists('5', $array) 将返回 false （由于严格比较）
     */
    public static function exists($value, $array): bool
    {
        return in_array($value, $array, true);
    }

}

